home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / Grafik⁄DTP / FloatingFractals.5.0.(FA folder / Adam's Quirky ReadMe 5.0 next >
Text File  |  1994-12-08  |  9KB  |  129 lines

  1. Floating Fractals 5.0b
  2. Fastest Mac Mandelbrot Program in the Free World
  3.  
  4. ReadMe (A SimpleText Document)
  5. "Teachtext" will not display this document with the proper fonts and colors.
  6. If the title "Floating Fractals 5.0ß" is not big and blue... your textreader sucks!
  7.  
  8. Thank you for downloading this fractal learning tool.
  9. Adam Smith is reachable (but not tangible) at: smithab@mailbox.syr.edu for bug reports, suggestions, comments, whatever....
  10. If you use my program, send me e-mail! Especially if you use this as a fractal teaching tool.  Yes, you are obligated : )
  11.  
  12. Why version 5.0 is so <explicit adjective> special:
  13.  
  14. This is the first 'fat' binary release with code for PowerMacs and FPU-equipt 680x0 Macs.
  15. New smaller application size means less time to download, more time to play!
  16.  
  17. New This Release (from version 3.1):
  18.  
  19. •30% Faster calculations of all sets on PowerMacs! RISC Optimized!
  20. •Implementation of the 'Divide and Conquer' Mariani-Silver algorithm we love so much. Hold down the control-key when choosing 'Fractalize!' to see approximations.
  21. •Window contents now scale themselves when the window size is changed!
  22. •Real-time Julia Set Calculations (Hold down Option and click-and-hold-and-drag in the fractal window, zooming is not implemented for Julia sets.)
  23. •Full-Screen view up to 832 by 624.
  24. You can now save images that are exactly the size of your screen (for deskpicts, startups etc…)
  25.  
  26. •Choices window sizes: (in addition to full-screen view)
  27.     (640 by 480)  and (320 by 240)  on a really big monitor
  28.     (480 by 360) and (320 by 240) on a standard 640 by 480 Apple monitor
  29.     even smaller on a 512 by 384 monitor (but nobody uses these right?)
  30.     Use zoom box to toggle window size.
  31.  
  32. •Has Option for maintaining Aspect-Ratio. If you turn this off, you can stretch and warp the fractals, but when you turn it back on it won't reverse the damage (it locks on the current H:W ratio!)
  33. •New "About…" dialog, cool         :-P
  34. •New command key equivalents and menu appearances.
  35. •Calculates the default view on program launch ('cause it's fast)
  36. •New HSV palattes (They look uglier in the default view, but look cool when you zoom way in)
  37. I am currently working on the palattes to find a good compromise for better looking julia sets.
  38. •Eats more RAM for a 832 by 624 buffer. Now a whopping 2.6Mb RAM slammer!
  39. •Uses RAM much more efficiently however. (old versions wasted perfectly good RAM with unecessary buffering)
  40.  
  41. Running Floating Fractals:
  42.  
  43. You should be able to simply double click to launch.
  44. Do not use this product with any "non-prescription" drugs.
  45.  
  46. Files that comprise Floating Fractals:
  47.  
  48.     ReadMe "Floating Fractals" (You are reading this now)
  49.     Floating Fractals 5.0ß (FAT)
  50.  
  51. Required Hardware Configuration:
  52.  
  53. A good mac.  
  54. More specifically, a color Macintosh with 3 Free MB of RAM and an FPU (881/882/882subset)
  55. Floating fractals will not run satisfactorily with FPU emulators!
  56. PowerMac and Monitor with Thousands of colors recommended (of course).
  57. This program will run fastest in Thousands or Millions of colors mode.
  58. Some transparent features may also require Quicktime.
  59.  
  60. Best calc. times (640 by 480 Mandelbrot set @ 100 iterations) :
  61.  
  62. /Raster Mode/                                                PowerMac 7100/66                                            0.95 seconds :-)
  63.                                                                        Centris 650 25MHz                                             8.16 seconds :-(
  64.  
  65. /Div. and Conq./                                            PowerMac 7100/66                                            1.03 seconds :-)
  66.                                                                                              Centris 650 25MHz                                             11.35 seconds >:-[
  67.  
  68. Using Floating Fractals:
  69.  
  70. I got sick of detailing the program's use in each release. Sorry. My time is better spent programming than re-writing these docs. I think my program is pretty self explanatory. Play with all the menus and have fun : )
  71.  
  72. The Main Viewing Sector (opened upon launch) choose an appropriate size for itself on your screen with a maximum size of 640 by 480 on monitors supporting 832 by 624 or larger displays.
  73.  
  74. You may have to pump up the  iteration multiplier if you zoom way in.  If out-of-set areas are not solid-colored, for example, or if the set is black and blotchy.  A setting of 2500 for Maximum iterations should be enough for most of life's problems.
  75.  
  76. The Fractals:
  77.  
  78. The Mandelbrot Set:  The famous one of the bunch. Hooray :-|
  79. The Drawn and Quartered Mandelbrots:  The Mandelbrot Set, with a hyperbolic-type singularities at the origin (division by zero!) will calculate slower that other fractals.
  80. The True Delta Set:    A manipulation of the Mandelbrot function.  Contains miniature likenesses of itself and of the Mandelbrot Set (Look Hard!).
  81. Others:  Atemporal manifestations of my 3rd Stage Guild Navigating Mind.  These contain interesting spiral and fluid-like space-time discontinuous tensor manifold fields. (Whatever!)
  82.  
  83.                                                                                 Now, Fractalize! and enjoy.
  84.  
  85. Technical Notes:
  86.  
  87. The name "Floating Fractals" refers to only two things, and could thus be considered a condensed form of "Floating-Point Numeric Fractal Generator".
  88. Code was generated with Metrowerks’ CodeWarrior C for PPC.
  89. I used my trusty 7100/66 16/250 to test the 601 code, and on occasion,
  90. our school's Q650's and a Q800 to test the '040 code.  I also compiled the SANE version for 68K so that I could test the 68K application on my 882-less PowerMac in emulation-mode, but this only proved that PowerMac emulation of the 68LC040 is more stable than a real '040!
  91. Other than what I have checked, there has been little testing of this program.  Bugs are likely, especially on computer configurations that are non-standard or not available for me to test this program on.  Runs OK on my IIvx too.
  92.  
  93. Floating Fractals is from my original C source.  It uses a true RGB palatte, selected according to escape time (not by true point potential, however), and calculated from an HSV hue or value ramp.  All GWorlds are 16-bit.  All calulations are done with 64-bit doubles on the Powermacs.  The other sample Fractal Sets provided, I made up. Most are not really near-self-similar like the Mandelbrot set, but they have some neat patterns within.
  94.  
  95. Floating Fractals has a formula that determines how many iterations are to be done, based on the real number range of the viewing area.  The number of iterations is proportional to some
  96. log of the real number range.  I provided a simple scalar control over this function, Iteration Multiplier.  This allows you to multiply the number of iterations in cases where you do not feel that the picture is accurate enough.
  97.  
  98. Shortcomings:
  99.  
  100. 1.    The calculation routine locks up the interface and only offers the standard Command-period abort.  I most likely will not fix this any time soon.  On PowerMacs, calculation time is short enough that no one would want to background it (about 0.95 seconds for the default image on an 832 by 624 monitor on my 7100).
  101.  
  102. 2.    My algorithm for finding solid color areas is bit of a hack.  For speed on the 68K machines, I don’t do a thorough check of block border pixels.  For this reason, You may see solid block artifacts once every 17,000 years. Too Bad.
  103.  
  104. 3.  Creates PICT files with it's own application signature, but cannot re-open them. Oh well.
  105.  
  106. 4.  Still has no practical, real-world applications.
  107.  
  108. 5.  Still doesn't cure cancer either, sorry.
  109.  
  110.  
  111. Possible Bugs/Acknowledged Problems:
  112.  
  113. 1.    Problem:     Using the divide and conquer algorithm, block sizes often become odd-sized, and are thus no longer even divisions of the window size. This will not affect the resultant image, but is an internal problem for memory writes nonetheless, and may inhibit features in future versions.
  114.  
  115. 2.     Problem!:  I hacked this App between my engineering finals.  Hey it was free, OK?
  116.  
  117. 3.     Problems:  I still use too many exclamation points in my documentation!!! I dont yous spelcheking eathir.
  118.  
  119. Thanks to: (finally!):
  120.  
  121. •“The New Galactic Emperor” Garth Henning here at syr.edu for his help with function pointers and RISC optimization and for his numerous tips that kept me away from my debugger.
  122. •Dave Hochhauser at kent.edu for his time spent beta testing and optimizing my core routine code, and for animating my marquee.
  123. •Tony Yang at tufts.edu for his on-line help in the aesthetics dept. and the time he spent testing out early versions. 
  124. •Thanks to everyone else who tried out my program but may not wish to be mentioned by name.
  125. •No thanks to Davis, whose contempt for mac hackers shames the institution of public education!
  126.  
  127. The Fine Print (Read Carefully!)
  128.  
  129. Floating Fractals 5.0ß by Adam Smith, Dec, 1994. You take the risks, should any exist.  I am not a computer scientist (yeah!); I am a janitor at Syracuse University, Techno-MIDI junky and former //e programmer who just thinks PowerMacs and Fractals are cool beans!)  This software is freeware, but I retain all my rights to it.  You may not use this software for any commercial purposes without consent from its author (me).  As this is a learning tool, distribution without the accompanying documentation is strongly discouraged, as is distribution of code-stripped single CPU copies. No, I am not really a janitor!  Have you seen my dog 'chugs' ? Quickdraw, Macintosh and Power Macintosh are registered trademarks of Apple Computer, Inc.